using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using JGSY.CMS.LowCode.Platform.Application.DTOs;

namespace JGSY.CMS.LowCode.Platform.Application.Interfaces
{
    /// <summary>
    /// 系统设置应用服务接口。
    /// 提供系统配置参数的增删改查和按类别查询等系统设置管理功能接口定义。
    /// </summary>
    public interface ISystemSettingAppService
    {
        /// <summary>
        /// 获取所有系统设置
        /// </summary>
        /// <returns>系统设置列表</returns>
        Task<IEnumerable<SystemSettingDto>> GetAllAsync();
        
        /// <summary>
        /// 根据ID获取系统设置
        /// </summary>
        /// <param name="id">系统设置标识符</param>
        /// <returns>系统设置信息</returns>
        Task<SystemSettingDto?> GetByIdAsync(long id);
        
        /// <summary>
        /// 添加新的系统设置
        /// </summary>
        /// <param name="dto">系统设置数据传输对象</param>
        /// <returns>添加任务</returns>
        Task AddAsync(SystemSettingDto dto);
        
        /// <summary>
        /// 更新系统设置
        /// </summary>
        /// <param name="id">系统设置标识符</param>
        /// <param name="dto">系统设置数据传输对象</param>
        /// <returns>更新任务</returns>
        Task UpdateAsync(long id, SystemSettingDto dto);
        
        /// <summary>
        /// 删除系统设置
        /// </summary>
        /// <param name="id">系统设置标识符</param>
        /// <returns>删除任务</returns>
        Task DeleteAsync(long id);
        
        /// <summary>
        /// 按类别获取系统设置
        /// </summary>
        /// <param name="category">设置类别</param>
        /// <returns>指定类别的系统设置列表</returns>
        Task<IEnumerable<SystemSettingDto>> GetByCategoryAsync(string category);
    }
}
